Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movies and Your Event Loop

GetMovieStatus

The GetMovieStatus function searches for errors in all the enabled tracks of the movie. This function returns information about errors that are encountered during the processing associated with the MoviesTask function (described on page 2-110). These errors typically reflect playback problems, such as low-memory conditions.

pascal ComponentResult GetMovieStatus (Movie theMovie, 
                                       Track *firstProblemTrack);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

firstProblemTrack

Contains a pointer to a track identifier. The Movie Toolbox places the identifier for the first track that is found to contain an error into the field referred to by this parameter. If you do not want to receive the track identifier, set this parameter to nil.

DESCRIPTION

The GetMovieStatus function returns the error from the first problem track. If the component does not find any errors, the result is set to noErr.

ERROR CODES

Any Movie Toolbox result code (see "Summary of the Movie Toolbox" at the end of this chapter)